home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat7 / usrvme.z / usrvme
Encoding:
Text File  |  2001-04-17  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. uuuussssrrrrvvvvmmmmeeee((((7777MMMM))))                                                          uuuussssrrrrvvvvmmmmeeee((((7777MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      usrvme - User level VME Bus adapter interface.
  10.  
  11.  
  12. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  13.      The _u_s_r_v_m_e interface provides access to VME bus address spaces from user
  14.      processes.
  15.  
  16.  
  17.    CCCChhhhaaaalllllllleeeennnnggggeeee aaaannnndddd OOOOnnnnyyyyxxxx SSSSyyyysssstttteeeemmmmssss
  18.      On Challenge and Onyx systems, access to VME bus address spaces are
  19.      provided by special files.  They're named according to the following
  20.      convention:
  21.  
  22.      ////ddddeeeevvvv////vvvvmmmmeeee////vvvvmmmmeeee<<<<aaaaddddaaaapppptttteeeerrrr>>>>aaaa<<<<aaaaddddddddrrrreeeessssssss----ssssppppaaaacccceeee>>>><<<<aaaaddddddddrrrreeeessssssss----mmmmooooddddeeee>>>>
  23.  
  24.      <adapter> is the number of VME bus adapter.
  25.      <address-space> is one of {_1111_6666, _2222_4444, _3333_2222}.
  26.      <address-mode> is either _nnnn for non-privileged or _ssss for supervisory.
  27.  
  28.      For instance, address space 16 in non-privileged mode on adapter 0 would
  29.      be referred to as /_d_e_v/_v_m_e/_v_m_e_0_a_1_6_n.
  30.  
  31.      The kernel driver for user level VME is referred to as _u_s_r_v_m_e.  If VME
  32.      busses are added to an existing system, it may be necessary to run
  33.      _M_A_K_E_D_E_V(1M) specifying a target of _u_s_r_v_m_e in order to have the additional
  34.      /_d_e_v/_v_m_e devices created.
  35.  
  36.  
  37.    OOOOrrrriiiiggggiiiinnnn2222000000000000 aaaannnndddd OOOOnnnnyyyyxxxx2222 SSSSyyyysssstttteeeemmmmssss
  38.      On Origin2000 and Onyx2 systems, VME bus address spaces can be accessed
  39.      by hardware graph vertices.  The vertices are named by the following
  40.      convention:
  41.  
  42.      ////hhhhwwww////vvvvmmmmeeee////<<<<aaaaddddaaaapppptttteeeerrrr>>>>////uuuussssrrrrvvvvmmmmeeee////<<<<aaaaddddddddrrrreeeessssssss----ssssppppaaaacccceeee>>>>////<<<<ddddaaaattttaaaa----wwwwiiiiddddtttthhhh>>>>
  43.  
  44.      <adapter> is the number of VME bus adapter.
  45.      <address-space> is the code for address space.  It could be one of
  46.      {_aaaa_3333_2222_ssss,_aaaa_3333_2222_nnnn, _aaaa_2222_4444_ssss, _aaaa_2222_4444_nnnn, _aaaa_1111_6666_ssss, _aaaa_1111_6666_nnnn}.
  47.      <data-width> is the maximum PIO data width on VME bus.  It could be one
  48.      of {_dddd_6666_4444, _dddd_3333_2222, _dddd_1111_6666, _dddd_8888} in A32 space, or one of {_dddd_3333_2222, _dddd_1111_6666, _dddd_1111_6666, _dddd_8888} in A24
  49.      and A16 spaces.
  50.  
  51.  
  52.    EEEErrrrrrrroooorrrr HHHHaaaannnnddddlllliiiinnnngggg
  53.      Not all addresses can be read from or written to because of read-only or
  54.      write-only registers and unequipped addresses. Reads or writes to invalid
  55.      VME bus addresses will normally result in a SIGBUS signal being sent to
  56.      the offending process.
  57.  
  58.      On CHALLENGE, ONYX, Origin2000, and ONYX2 systems, writes to an invalid
  59.      VME bus address are asynchronous, processor does not wait for the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uuuussssrrrrvvvvmmmmeeee((((7777MMMM))))                                                          uuuussssrrrrvvvvmmmmeeee((((7777MMMM))))
  71.  
  72.  
  73.  
  74.      completion of write operation.  If write operation fails, it could take
  75.      up to 10 millisecs for the user VME process to be signalled about failed
  76.      write.  (Note that VME bus timeout is about 80 microsecs on Challenge and
  77.      Onyx systems, 64 microseconds on Origin2000 and Onyx2 systems.)  So, if
  78.      the user VME process has to confirm that the write completed
  79.      successfully, it should wait for about 10 millisecs.  If the user VME
  80.      process has already terminated by the time kernel gets the VME write
  81.      error interrupt, a message is sent to SYSLOG indicating the VME Adapter
  82.      number, and failed VME bus address.
  83.  
  84.      If multiple processes have the mapping for the VME address which got an
  85.      error, all of them would be sent SIGBUS signal.
  86.  
  87.  
  88. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.      "IRIX Device Driver Programmer's Guide"
  90.      hinv(1M)
  91.      MAKEDEV(1M) -- on Challenge and Onyx systems.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.